1. 确保已经安装 Flutter SDK

首先，确保的系统上安装了 Flutter SDK。如果没有安装，可以参考以下步骤：

安装 Flutter SDK：

1. 访问 Flutter 官网 并下载适用于操作系统的 Flutter SDK。

2. 解压下载的文件并将 Flutter 添加到系统路径中。

   • Windows：将 flutter/bin 目录添加到环境变量 PATH 中。

   • Mac/Linux：在 .bashrc 或 .zshrc 文件中添加以下行：

     1	export PATH="$PATH:`<flutter_sdk_path>/flutter/bin"

确认 Flutter 是否安装：

在终端或命令提示符中运行以下命令来确认 Flutter 是否安装成功：

1

flutter --version

2. 安装 Android Studio 或其他 IDE（用于模拟器）

确保有一个 Android 模拟器，或者已连接真实设备（如果要进行 Android/iOS 开发）。可以安装 Android Studio 或直接使用 VS Code 进行开发，但 Android Studio 带有模拟器，便于开发。

• Android Studio：安装 Android Studio，并确保安装了 Android SDK 和模拟器。
• VS Code：VS Code 本身无法直接启动模拟器，但可以通过 Android Studio 提供的模拟器进行配合。

3. 在 VS Code 中安装 Flutter 插件

为了在 VS Code 中开发 Flutter 应用，需要安装两个插件：Flutter 和 Dart。

安装 Flutter 和 Dart 插件：

1. 打开 VS Code。
2. 转到 扩展（Extensions）视图：点击左侧活动栏中的 扩展 图标，或者使用快捷键 Ctrl+Shift+X。
3. 在搜索框中输入 Flutter，然后点击 安装。
4. 在搜索框中输入 Dart，然后点击 安装。

4. 通过 VS Code 打开 Flutter 项目

1. 使用 VS Code 打开由 GitHub Copilot 创建的 Flutter 项目文件夹。点击 文件 > 打开文件夹，然后选择的 Flutter 项目文件夹。

2. 可以在 VS Code 的 终端（Terminal）中运行以下命令，确保所有依赖已安装：

   1	flutter pub get

5. 连接设备或启动模拟器

1. 连接设备：如果有 Android 或 iOS 设备连接到计算机，可以直接使用设备运行应用。

2. 启动模拟器：

   • 如果使用的是 Android Studio，可以通过 AVD 管理器（Android Virtual Device）启动模拟器。
   • 启动模拟器后，VS Code 会自动检测到模拟器。

   也可以通过 命令面板（Ctrl+Shift+P）运行以下命令：

   1	Flutter: Launch Emulator

6. 在 VS Code 中运行 Flutter 应用

1. 确保设备或模拟器已连接并显示在 VS Code 状态栏的 设备选择 处。

2. 在 VS Code 中按下 F5 或点击 运行（Run）按钮来启动应用。也可以使用 终端 执行：

   1	flutter run

VS Code 将会构建并运行的 Flutter 应用，输出将在 终端 中显示。

7. 调试与热重载

• 在运行 Flutter 应用时，VS Code 支持热重载（Hot Reload）。只需点击 热重载 图标或在终端中输入 r，就可以查看代码修改后的效果。
• 还可以设置断点并调试应用。

总结：

• 确保安装了 Flutter 和 Dart 插件。
• 通过 VS Code 打开 Flutter 项目。
• 确保连接设备或启动模拟器。
• 使用 F5 运行应用，或通过终端输入 flutter run。

8.avdmanager is missing from the Android SDK

1. 确保 Android SDK 安装完整

AVD Manager 是 Android Studio 中的一部分，但它依赖于 Android SDK 的某些工具。因此，确保的 SDK 已经安装并更新到最新版本。

安装或更新 SDK 工具：

1. 打开 Android Studio。

2. 选择 Configure > SDK Manager。

3. 在 SDK Tools 标签页中，确保以下工具已经选中并安装：

   • Android SDK Build-Tools
   • Android Emulator
   • Android SDK Platform-Tools
   • Android SDK Tools（如果显示）

4. 点击 OK 以应用更改并安装缺失的工具。

2. 手动安装 AVD Manager

如果没有 Android Studio，或者只安装了命令行工具，可以手动安装并配置 AVD Manager。

安装 AVD 工具：

1. 打开终端或命令行。

2. 使用 sdkmanager 工具来安装缺少的组件。确保已经将 Android SDK 的路径添加到 PATH 环境变量中。如果没有，可以在终端中运行：

   1 2 3 4

   sdkmanager --update sdkmanager "system-images;android-30;google_apis;x86_64" sdkmanager "platform-tools" sdkmanager "emulator"

   上面的命令会安装 SDK 平台工具、模拟器和系统映像（适用于 Android 30）。

3. 等待下载并安装完成。

3. 检查环境变量

确保 AVD Manager 所需的命令行工具在的 PATH 中。

设置环境变量：

1. Windows：

   • 打开 系统属性 > 高级系统设置 > 环境变量。

   • 在 系统变量 中找到 Path，并点击 编辑。

   • 添加以下路径（替换为实际的 Android SDK 路径）：

     1 2	C:\Users\<YourUsername>\AppData\Local\Android\Sdk\tools C:\Users\<YourUsername>\AppData\Local\Android\Sdk\platform-tools

2. Mac/Linux：

   • 打开终端并编辑 .bashrc 或 .zshrc 文件：

     1	nano ~/.bashrc # 或 nano ~/.zshrc

   • 添加以下行：

     1 2	export PATH=$PATH:/Users/<YourUsername>/Library/Android/sdk/tools export PATH=$PATH:/Users/<YourUsername>/Library/Android/sdk/platform-tools

   • 保存并运行：

     1	source ~/.bashrc # 或 source ~/.zshrc

4. 使用命令行启动 AVD

如果没有 Android Studio 的图形界面，可以使用命令行启动 AVD：

1. 打开命令行或终端。

2. 使用以下命令启动模拟器：

   1	emulator -avd <avd_name>

   其中，<avd_name> 是创建的虚拟设备名称。

   如果没有创建 AVD，可以通过以下命令创建一个新的虚拟设备：

   1	avdmanager create avd -n <avd_name> -k "system-images;android-30;google_apis;x86_64"

5. 检查 AVD 是否可用

可以列出可用的 AVD：

1

avdmanager list avd

如果仍然无法找到 AVD Manager，可能是 SDK 安装有问题，尝试重新安装 SDK 或 Android Studio。

总结：

• 确保 SDK 工具和模拟器已经正确安装。
• 配置 PATH 环境变量，确保命令行工具可用。
• 使用 avdmanager 命令手动创建 AVD（如果需要）。
• 通过命令行启动模拟器，或者通过 Android Studio 使用 AVD Manager。

6.VS Code 中成功启用 GitHub Copilot，需要完成以下 5 个关键步骤。

✅ 1. 安装 GitHub Copilot 插件

1. 打开 VS Code

2. 按 Ctrl + Shift + X 打开扩展（Extensions）

3. 搜索并安装插件：

   1	GitHub Copilot

   ✅ 选择 GitHub 官方发布的那个（发布者是 GitHub）

✅ 2. 登录的 GitHub 账户

1. 安装后，VS Code 会提示：

   “GitHub Copilot requires authentication”

2. 点击“Sign in”

3. 浏览器会打开 GitHub 授权页面

4. 确认授权并登录的 GitHub 账号

⚠️ 必须是：

• 拥有 Copilot 订阅（付费或试用中）
• 或属于 GitHub Copilot 企业授权的用户

✅ 3. 验证登录成功

登录成功后，可以：

• 在 VS Code 命令面板中（Ctrl + Shift + P）输入：

  1	Copilot: Status

  ✅ 若看到 “Logged in as your_github_name” 即为成功。

✅ 4. 启用自动补全

打开的代码文件（.dart, .js, .py, .cpp 等都支持），开始写函数名，Copilot 会自动在灰色字体中提示补全建议。

可以按：

• Tab → 接受补全建议
• Esc → 忽略建议

✅ 5. 可选：安装 Copilot Chat（对话增强版）

如果希望像 ChatGPT 那样和 Copilot 聊天，获取更复杂建议，还可以安装：

1

GitHub Copilot Chat

这个插件支持自然语言提问，例如：

“帮我写一个 Flutter 登录界面”
“优化这个函数的性能”

🛠️ 常见失败原因排查

6.✅ 附加建议：测试是否工作正常

可以在新文件中输入以下代码片段测试：

1
2
3

void main() {
  // Copilot 应该会自动补全一个打印 hello world
}

看是否自动灰色提示 print("Hello World"); 或其它逻辑。

如操作中遇到某个具体步骤失败，欢迎贴出提示信息，我可以帮一步步修复。是否需要我检查现在的系统环境变量、代理配置或 Dart/Flutter 插件兼容性？

9. 在 Android Studio 或 VS Code 中配置 Virtual Device（模拟器） 时，选择合适的设备型号和系统镜像（API Level）非常关键。

✅ 推荐虚拟设备配置（2025 年通用建议）

🛠️ 示例推荐配置（开发+测试兼顾）

1
2
3
4
5
6

Device: Pixel 5
System Image: Android 13 (API 33) - x86_64 with Google APIs
RAM: 2048MB
Internal Storage: 2GB
SD Card: 512MB（可选）
Graphics: Hardware - GLES 2.0 / 3.0

❗ 不建议选择：

💡 Flutter 快速测试建议

可以选配两个虚拟设备：

📌 重要提示：性能建议

• 启用 Hardware Acceleration（加速），否则模拟器会非常卡
• 如果是 AMD CPU，确保已启用 Windows Hypervisor Platform
• 推荐使用 x86_64 镜像 + Cold boot only once 提高启动速度

10.当前的 Java 环境是：

1
2
3

openjdk 18 2022-03-22
OpenJDK Runtime Environment (build 18+36-2087)
OpenJDK 64-Bit Server VM (build 18+36-2087, mixed mode, sharing)

✅ 这表明已经安装了 OpenJDK 18，完全符合 Android 开发（尤其是 Android 14 / API 34）对 Java 版本的要求（Java 17 或更高）。

✅ 那么为什么仍然提示 “Java version 17 or higher is required”？

这种情况通常有两个可能原因：

🔍 原因 1：Android Studio / Gradle 没有使用当前的 JDK 18

即使安装了 JDK 18，如果的 JAVA_HOME 没有正确配置，Android Studio 或 flutter build 命令仍然可能默认使用旧版本 JDK（比如 JDK 8 或 JDK 11）。

✔️ 解决方法：

✅ 设置 JAVA_HOME 环境变量

Windows：

1. 打开“环境变量设置”。

2. 添加 / 修改系统变量：

   • 变量名：JAVA_HOME

   • 变量值： JDK 18 的安装路径，比如：

     1	C:\Program Files\Java\jdk-18

3. 在系统变量 Path 中添加：

   1	%JAVA_HOME%\bin

4. 打开新终端，运行：

   1 2	java -version echo %JAVA_HOME%

macOS/Linux（bash/zsh）：

编辑 ~/.bashrc 或 ~/.zshrc 文件，添加：

1
2

export JAVA_HOME=/path/to/your/jdk-18
export PATH=$JAVA_HOME/bin:$PATH

然后运行：

1
2
3

source ~/.bashrc  # 或 ~/.zshrc
java -version
echo $JAVA_HOME

🔍 原因 2：Android Studio 项目仍指向旧 JDK 路径

即使系统环境正确，Android Studio 本身可能还指向旧 JDK 路径。

✔️ 在 Android Studio 中设置正确的 JDK 版本

1. 打开 Android Studio。

2. 进入菜单：File > Project Structure > SDK Location。

3. 找到 JDK Location 字段，点击右侧文件夹图标。

4. 指向 JDK 18 的路径，如：

   1	C:\Program Files\Java\jdk-18

5. 点击 OK 保存设置，重启 Android Studio。

🔁 最后验证

确保以下命令都输出了 JDK 18 相关信息：

1
2
3

java -version
echo $JAVA_HOME  # Linux/macOS
echo %JAVA_HOME% # Windows

如果是在使用 flutter 构建 Android 应用，也可以运行：

1

flutter doctor -v

确认输出中使用的是正确的 Java 路径和版本。

✅ 总结

11.AVD（Android Virtual Device）模拟器是可以修改默认安装位置的，尤其在 C 盘空间紧张时，这是非常常见的需求。

🧭 默认位置在哪里？

AVD 默认保存在：

• Windows：

  1	C:\Users\<的用户名>\.android\avd

• macOS/Linux：

  1	~/.android/avd

✅ 修改 AVD 安装路径的方法（推荐方法：设置环境变量）

方法一：设置 ANDROID_AVD_HOME 环境变量

可以通过设置环境变量来改变 AVD 存放路径。

🔧 步骤（Windows 示例）：

1. 创建想放 AVD 的新路径，如：

   1	D:\AndroidAVD

2. 打开系统“环境变量设置”。

3. 新增一个 用户环境变量：

   • 变量名：ANDROID_AVD_HOME

   • 变量值：刚才创建的路径，例如：

     1	D:\AndroidAVD

4. 确认保存，重启 VS Code / Android Studio / 终端。

5. 重新创建或运行模拟器时，它会自动使用新的目录。

方法二：命令行运行 AVD 时指定路径（不常用）

也可以通过命令行运行 avd 时使用 -data 参数指定数据文件位置，但这只是临时改变，不如方法一彻底。

💡 补充：修改 Android SDK 的安装路径

如果也希望 SDK 也换个位置（默认在 C:\Users\<>\AppData\Local\Android\Sdk）：

1. 在 Android Studio 中：

   • File > Settings > Appearance & Behavior > System Settings > Android SDK
   • 点击右上角的 “Edit” 可以修改 SDK 路径。
   • 之后可能需要重新安装一些组件（如 emulator / platform-tools 等）。

🧪 验证是否生效

设置完后可以检查：

• 终端运行：

  1 2	echo %ANDROID_AVD_HOME% # Windows echo $ANDROID_AVD_HOME # macOS/Linux

• 检查 AVD 文件是否已出现在新路径下，比如 D:\AndroidAVD\Pixel_5_API_34.avd 等。